CruiseControl.NET : StarTeam Source Control Block
This page last changed on Mar 08, 2005 by mroberts.

StarTeam Configuration Example

For StarTeam you must specify the executable, project, username and password. You may also specify the host, port and path. The host defaults to 127.0.0.1. The port to 49201. The path to the empty string.

<sourcecontrol type="starteam">
   <executable>c:\starteam\stcmd.exe</executable>
   <project>ccnet</project>
   <username>buildguy</username>
   <password>buildguypw</password>
   <host>thebuildmachine</host>
   <port>49201</port>
   <path>release2.0</path>
   <autoGetSource>true</autoGetSource>
   <folderRegEx>customRegEx</folderRegEx>
   <fileRegEx>customRegEx</fileRegEx>
   <fileHistoryRegEx>customRegEx</fileHistoryRegEx>
</sourcecontrol>

Configuration Elements:

Node Description Type Default Required
executable The local path for the StarTeam command-line client (eg. c:\starteam\stcmd.exe) string "stcmd.exe" true
username StarTeam ID that CCNet should use string N/A true
password Password for the StarTeam user ID string N/A true
host The IP address or machine name of the StarTeam server. string N/A false
port The port on the StarTeam server to connect to. integer 49201 false
project The StarTeam project (and view) to monitor (eg. project/view) string N/A true
path The path to monitor. string "" false
autoGetSource Instruct CCNet whether or not you want it to automatically retrieve the latest source from the repository. bool false false
overrideViewWorkingDir If set, use the -rp option to use a different View Working Directory string false ""
overrideFolderWorkingDir If set, use the -fp option to use a different Folder Working Directory. Will not be used if overrideViewWorkingDir is set. string false ""
folderRegEx Allows you to use your own RegEx to parse StarTeam's folder output. See RegEx's below. string false See below
fileRegEx Allows you to use your own RegEx to parse StarTeam's file output. See RegEx's below. string false See below
fileHistoryRegEx Allows you to use your own RegEx to parse StarTeam's file history. See RegEx's below. string false See below

RegEx Configuration

CruiseControl.NET uses StarTeam's command line interface to find changes submitted to Source Control. 3 regular expressions are used in doing this, as specified above. You have the option of changing these regular expressions to choose how your instance of CruiseControl.NET parses StarTeam output. It is recommended if you do this that you download the source version of CruiseControl.NET to see the default RegEx's and how they are used.

One suggested alternative RegEx so far is for the fileHistoryRegEx, as follows: 
^Revision: (?<file_revision>\S+) View: (?<view_name>.+) Branch Revision: (?<branch_revision>\S+).\nAuthor: (?<author_name>.*) Date: (?<date_string>.*) \w+\r\n(?<change_comment>.*)
 

(Note that this is all one line)
Document generated by Confluence on Jun 26, 2005 17:23